_n_a_m_e A port _n_a_m_e is a character string describing the port. It is
intended for human consumption, similar to a window title.
Port names have a maximum length of 20 characters.
_d_i_r_e_c_t_i_o_n Specifies whether the port is for input or output.
""""rrrr"""" specifies an input port.
""""wwww"""" specifies an output port.
_c_o_n_f_i_g Expects an AAAALLLLccccoooonnnnffffiiiigggg, as returned by aaaallllNNNNeeeewwwwCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))) or
aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))). This structure describes the data format
and queue size for the port.
Passing a null (0) value for _c_o_n_f_i_g yields a port with the
default configuration.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt((((3333ddddmmmm)))) allocates and initializes an audio ppppoooorrrrtttt (AAAALLLLppppoooorrrrtttt). An
audio port is the mechanism through which an application reads or writes
real-time audio data. There are two types of ports: input and output. An
input port receives a real-time stream of audio data from an audio input
device. An output port sends a single real-time stream of audio data to
an output device or devices.
A single application may have multiple ports open simultaneously, or
multiple applications may have ports open, either sharing audio devices
or using multiple audio devices. There is, however, a system-dependent
limit to the total number of audio ports active on a given system.
This limit can be found by retrieving the value of the AL_MAX_PORTS
parameter on the AL_SYSTEM resource; see aaaallllPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) and
aaaallllGGGGeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) for information on how to do this.
As soon as the call to aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt completes successfully, the port is
considered "open." This means it will be filling or draining audio data
in real-time at the rate of the audio device to which the port is
connected. The application must read or write enough data frequently
enough that the port does not underflow or overflow. Refer to
aaaallllRRRReeeeaaaaddddFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))), aaaallllWWWWrrrriiiitttteeeeFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))), aaaallllDDDDiiiissssccccaaaarrrrddddFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))), and
aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))) for more information on how to read and write audio